home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 126-150 / disk_147 / sys / atari / atari.zoo / readme.1st < prev    next >
Text File  |  1988-07-25  |  4KB  |  117 lines
  1. This file documents the Atari-specific features of MG2A.  Please refer
  2. to the MG manual and the tutorial for more general information about
  3. how to use MG.
  4.  
  5. This version of MG has been brought to you by....
  6.  
  7.     Sandra Loosemore (sandra@cs.utah.edu, utah-cs!sandra)
  8.     Marion Hakanson (hakanson@cs.orst.edu, orstcs!hakanson)
  9.  
  10.  
  11.  
  12. Keyboard Handling:
  13. ------------------
  14.  
  15. The ALT key acts as the META key.  The command meta-key-mode can be 
  16. used to toggle this behavior.  (On non-US keyboards, the ALT key is 
  17. normally used as a modifier with certain other keys to produce printing 
  18. characters.)
  19.  
  20. MG supports 8-bit characters, although since neither of us have
  21. European keyboards we have not been able to test this thoroughly.
  22.  
  23. The function keys may be bound to commands, although there are no 
  24. default bindings established for these keys.  F1-F10 are as on the 
  25. keyboard, F11-F20 are the shifted F1-F10, and F21-F28 are Help, Undo, 
  26. Insert, Up, Clr/Home, Left, Down, and Right, respectively.
  27.  
  28.  
  29. Startup Files:
  30. --------------
  31.  
  32. MG looks for its startup file first as MG.INI in the current directory,
  33. and it then looks for the file specified by the environment variable
  34. MGINIT if that fails.  The code to look up the environment variables
  35. checks for all of the various environment styles that are supported
  36. by common shells such as the MWC shell and Gulam, as well as the one
  37. built for the desktop by GEMBOOT.
  38.  
  39.  
  40. Spawning a Shell:
  41. -----------------
  42.  
  43. The suspend-emacs command checks the SHELL environment variable to
  44. determine what program to run.  If the environment variable is not
  45. set, or if the attempt to execute the program fails (i.e., the program
  46. is not found), MG will prompt for a command to execute.
  47.  
  48.  
  49. Other Options:
  50. --------------
  51.  
  52. Most of the optional features described in the MG manual are enabled,
  53. including the GOSMACS and DIRED features.  The major piece of missing
  54. functionality is the regular expression code, which is nonportable and
  55. won't compile on the ST.  There is also no support for backup files yet.
  56.  
  57.  
  58. Rebuilding MG:
  59. --------------
  60.  
  61. MG has been developed using both the Alcyon (v4.14) and Mark Williams 
  62. (v2.0) C compilers.  Makefiles (maketop.mwc and makesys.mwc) are provided 
  63. for MWC, and a Gulam shell script (build.g, also mglink.inp) for Alcyon.  
  64. You may need to tweak these files if you have moved things around.
  65.  
  66. Here is a list of the ST-specific source files:
  67.  
  68.     chrdef.h    Character macro definition file
  69.     sysdef.h    ST-specific definitions
  70.     ttydef.h    More ST-specific definitions
  71.     varargs.h       Definitions for varargs macros
  72.     alloc.c        New "malloc" for Alcyon C, also used by MWC.
  73.     cinfo.c        Character functions.
  74.     diredsup.c    Functions to support the "cd" and "dired" features.
  75.     fileio.c    File i/o functions.
  76.     misc.c        Functions to support "spawn", etc.
  77.     term.c        High-level screen manipulation functions.
  78.     ttyio.c        Low-level terminal i/o functions.
  79.     getn.s        Functions to determine screen resolution.
  80.     gemstart.s      Needed for Alcyon C
  81.  
  82.  
  83. Changes since MG1B:
  84. -------------------
  85.  
  86. File and terminal i/o have been completely rewritten to use low-level
  87. GemDOS functions instead of their C equivalents.  It's now much faster.
  88.  
  89. Improved memory management (new implementation of "malloc" and friends
  90. for Alcyon C) makes the "spawn" command more useful.
  91.  
  92. The use of the ALT key as a meta key and support for 8-bit characters is
  93. new.
  94.  
  95. The old "dirlist" function has been replaced by dired mode.
  96.  
  97. Environment variables are now used to specify the startup file and the
  98. shell to run for suspend-emacs.
  99.  
  100. A few minor cleanups and optimizations, some of which speed things
  101. up markedly.
  102.  
  103.  
  104. Bugs
  105. ----
  106.  
  107. There is a bug in TOS that may result in MG creating multiple copies of
  108. files with the same name.  It only seems to happen with very short files.
  109.  
  110. There has been some question raised about the use of the "conterm"
  111. system variable on the "new" (Mega-ST) TOS ROMs, even though such use
  112. is documented in the MWC manual, and elsewhere.  Perhaps someone can
  113. test this code on such a system and let us know if there are problems.
  114. A workaround would be to use Getshifts() separately, instead of having
  115. the kbshift value returned by Bconin().
  116.  
  117.